Trucks

Overview (C4 Component)

Black-box description of components

Component	Responsibility	Provided Interface(s)	Consumed Interface(s)
TruckController	REST endpoints for register/update/delete/search trucks.	/api/v1/trucks/** (OpenAPI)	—
TruckService	Core use-cases, soft-delete, provider validation, antennamerge, tech-spec aware search.	Spring service API	TruckRepository, ProviderRepository, TruckSpecificationBuilder, TruckMapper, AntennaService
TruckRepository	Persistence of Truck aggregate (soft-delete enabled).	Spring-Data JPA	MySQL via JDBC
AntennaService / AntennaRepository	Manage child Antenna value-objects inside a truck.	Java service / JPA repo	—
TruckSpecificationBuilder	Composes JPA Specification<Truck> from TruckFilterRequest.	Java class	TruckJsonSpecifications
TruckMapper / AntennaMapper	MapStruct mappers for DTO conversion.	Java interface	—
TruckJsonSpecifications	Static helper functions building JSON_EXTRACT predicates for tech-spec column.	Java class	—
ProviderRepository (external)	Provides provider look-up when registering trucks.	Spring-Data JPA	MySQL

Important internal interfaces

Name	Signature / Protocol	Notes
registerTruckForProvider	POST /api/v1/providers/{opsCode}/trucks – body TruckCreateRequest	Validates provider exists, creates truck & antennas, returns 201 Created.
updateTruck	PUT /api/v1/trucks/{id} – body TruckUpdateRequest	Updates scalar fields & merges/upserts antenna list.
deleteTruck	DELETE /api/v1/trucks/{id}	Soft-delete via @SQLDelete.
searchTrucks	GET /api/v1/trucks?q=<Base64Json>	Accepts encoded JSON filter; builder supports >30 predicates incl. tech-specs.
findByAntennaNumber	TruckService.findByAntennaNumber(String)	Used by Quote module to associate quotes with existing trucks.